home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d11 / vpic22.arc / VPIC.DOC < prev    next >
Text File  |  1989-11-29  |  32KB  |  586 lines
  1. VPIC.EXE ver 2.1A by Bob Montgomery [CIS 73357,3140]          8-23-89
  2. See revision history for new items. Next generation of VGIF; will now support
  3. various paint formats in addition to GIF. Configuration program supplied to
  4. configure VPIC to your extended VGA board. See revision history for latest
  5. additions and bug fixes.
  6.  
  7. IMPORTANT: Requires DOS 2.0 or up to run from current directory, or DOS 3.0 up
  8. to run from anywhere. You must configure VPIC for your graphics board (unless
  9. you have an Orchid Designer VGA with 512 K).
  10.  
  11. The Graphics Interchange Format (GIF) is a Service Mark owned by Compuserve
  12. Incorporated. For further information, please contact:
  13.     Compuserve incorporated, Graphics Technology Department,
  14.     5000 Arlington Center Boulevard, Columbus, Ohio 43220, USA
  15.  
  16. This is a file viewer for EGA, MCGA, VGA and SuperVGA with the following
  17. features:
  18.   *  Views the following file formats in EGA, MCGA, VGA, or SuperVGA:
  19.         GIF files (50% faster now)
  20.         ZSoft PCX files (including 256 color files)
  21.         ColorRIX/EGA Paint SCx files
  22.         Pictor/PC Paint PIC files
  23.         Targa 16 or 24 TGA files
  24.         Dr. Halo CUT files (with PAL if present)
  25.         Deluxe Paint LBM (or IFF) files
  26.         MAC files
  27.   *  Saves any picture to any of the above formats (except MAC) in the current
  28.         mode (EGA, MCGA, or VGA).
  29.   *  Allows you to save a GIF file of the current imgage in regular, interlaced,
  30.         inverted, mirrored, or rotated 90 degrees CW or CCW. Great for scans.
  31.   *  Configurable for display boards using Tseng, Paradise, Everex, ATI,
  32.         Trident, C&T, or Video 7 VGA chips; see configuring VPIC below.
  33.   *  /R option allows an application program to show a file and regain control
  34.      without changing the screen mode.
  35.   *  Mode can be manually selected or auto selected from menu.
  36.   *  Allows you to specifiy a new path from the menu with the F9 key. Also
  37.      updates menu when files are added or deleted.
  38.   *  Very fast GIF decoding.
  39.   *  Menu features:
  40.         Mark/unmark files for viewing with spacebar.
  41.         Menu text color setable in configuration file.
  42.         F1 gives help.
  43.         F2 shows marked files like a slideshow.
  44.         F3 gives file size and colors.
  45.         F4 toggles between EGA and VGA mode.
  46.         F5/F6 decrease/increase default resolution.
  47.         F7 locks current resolution, or selects auto resolution mode.
  48.         F8 Makes multiple images pause for a keypress.
  49.         F9 prompts for new path.
  50.         Shows specified files singly or like a slide show.
  51.         Handles up to 500 files.
  52.   *  Features while viewing a file:
  53.         Help while viewing with / or ? key.
  54.         Shows filename while decoding, and Escape key aborts decoding.
  55.         Allows deleting a file (with query) while viewing with X key.
  56.         Allows adjustment of picture color and VGA contrast and brightness.
  57.         Allows saving the current image as a GIF (many options),
  58.             PC Paint or Pictor, ZSoft PCX, ColoRIX or EGA Paint, Targa 16,
  59.             Dr. Halo CUT, and Deluxe PaintII formats in EGA, MCGA, or VGA.
  60. =============================================================================
  61. Format:
  62. vpic [[path\]filespec][/a][/e][/r][/c][/w][/?].
  63.      The default path is the current dir, and the default extension is GIF.
  64.      The /a option starts VPIC in Auto resolution select mode.
  65.      The /e option forces EGA mode, to use extended 16 color modes; see 5 below.
  66.      The /r option returns control to a calling program; see 4 below.
  67.      The /c option gives the current configuration; see 6 below.
  68.      The /w option wait for a keypress after each image in a multi_image file.
  69.      The /? option gives a help screen.
  70.      If filespec is a filename, the single file will be shown.
  71.      If path\filespec is a directory, a menu of all files meeting the filespec
  72.         int the path will appear.
  73.      Options and filespec may be entered in any order.
  74.  
  75. The options details are:
  76. 1. vpic [path\]filename[.ext] shows the file specified. The default path is the
  77.      current directory, and the default extension is GIF.
  78.  
  79. 2. vpic [path\][filespec] to get a menu of all files in the specified path
  80.      meeting filespec (may contain wildcards). The default path is the current
  81.      directory, and the default filespec is any of the viewable files; just
  82.      entering 'vpic' will give a menu of all viewable files in the current
  83.      directory. Shows whether VGA or EGA and modes supported in upper left
  84.      corner. Path may not be . or .. since these would be interpreted as an
  85.      extension spec.
  86.  
  87. 3. vpic /@[path\]slidefile[.ext]  to do a slide show from commands in the
  88.      slidefile file. The default path is the current directory, and the default
  89.      extension is SLD. The commands are placed on seperate lines, and consist of
  90.      either a filename (GIF extension assumed) and optional display mode, or a
  91.      delay (viewing time) spec of the form  d n where n is the desired viewing
  92.      time in seconds. The default viewing time is 5 seconds if no delay spec is
  93.      given, and the default viewing mode is whatever would look best. VPIC
  94.      understands comments preceded by a semicolon, blank or comment lines, and
  95.      extra spaces. For example, the following is file contents are understood by
  96.      VPIC, but not reccommended:
  97.  
  98.      file1  1    ;First file in slideshow. Use mode 1.
  99.          file2.pcx         ;This is a ZSoft filename with leading spaces
  100.        ;This is a comment line with leading spaces, next is a blank line.
  101.  
  102.      file3
  103.          d        15 ;Use 15 second delay. Has leading and separator spaces.
  104.      To end a slide show after the current picture, press any key. Escape ends
  105.      it immediately.
  106.  
  107.      The mode requires a little further explanation. In the above slide file,
  108.      it says to use mode 1 with file1. Modes 1 thru 10 are the VGA (256 color)
  109.      modes, and modes 11 thru 20 are EGA (16 color) modes called out in the
  110.      configuration file. Most display boards only have a few of each type. The
  111.      Orchid Designer has 4 VGA modes and 4 EGA modes in the configuration file.
  112.      The VGA modes are 1. 320x200, 2. 640x350, 3. 640x480, 4. 800x600, and the
  113.      EGA modes are 11. 640x350, 12. 640x480, 13. 800x600, 14. 1024x768. Then,
  114.      the slide file says to show file1 in the 320x200x256 mode, and show all the
  115.      others in the default modes.
  116.  
  117. 4. vpic /r shows the file and then returns to DOS (or a calling application
  118.      program) with the picture still on the screen in EGA/VGA. It is not
  119.      necessary to change video mode between viewing each file, but it is up to
  120.      the calling program to reset text mode (mode 3) after all viewing is done.
  121.      The /e and /a switches are valid in this mode.
  122.  
  123. 5. vpic /e forces and EGA display with VGA to use extended EGA modes.
  124.  
  125. 6. vpic /c prints the current configuration of vpic. You can configure vpic to
  126.    your display board using the VCONFIG program and a text configuration file
  127.    describing your board.
  128.  
  129. 7. vpic /a  starts VPIC in auto resolution mode.
  130.  
  131. 8. vpic /?  gives a help screen.
  132. ==============================================================================
  133. CONFIGURING VPIC
  134.    To configure VPIC, enter
  135.         CVPIC [config_file]
  136.    where the default configuration file is VPIC.CFG, which is for the Orchid
  137.    Designer VGA board with white menu text color. Generally, you will answer
  138.    n to the 1st question and y to the 2nd question.
  139.  
  140.    The default configuration of VPIC is for the Orchid Designer VGA card with
  141.    512K of display memory. If you have just EGA, you should use the EGA.CFG
  142.    file. If you have plain vanilla VGA (modes 10h, 12h, and 13h), use VGA.CFG.
  143.    The meaning of each field is given in display.brd, and the appropriate
  144.    portion of this file can be copied to a configuration file for most boards
  145.    using the Tseng, Paradise, Everex, ATI, or Video 7 VGA chip sets. Sample
  146.    configuration files are enclosed in this arc file for some of the more
  147.    popular boards, and can be modified for your board.
  148.  
  149. CONFIGURATION FILE - Characters after a ; are considered comments and ignored.
  150.    The first line is the board name, and will appear in the VPIC menu.
  151.    The 2nd line is the chip set, and should be TSENG, PARADISE, EVEREX, ATI,
  152.         C&T, VIDEO7, TRIDENT, or GENERIC presently.
  153.    The 3rd line is the number of 64K banks of display ram usable for 256 color
  154.         VGA pics (1 for standard VGA).
  155.    The 4th line is the menu text color; 0 thru 15 corresponds to black, blue,
  156.         green, aqua, red, violet, brown, white + 8 bright versions. For example
  157.         12 would be bright red text.
  158.    The following lines describe the modes supported by the board. Each field
  159.       is of the form     F1 F2 AX BX CX DX W H C     where:
  160.                 F1 = VGA (256 color) mode flag.
  161.                 F2 = 16/256 colors (as in mode 12h) flag.
  162.                 AX,BX,CX,DX  register values used to set this mode.
  163.                 W, H, C  are width, height, colors in this mode.
  164.     All the VGA (256 color) modes should be grouped first, followed by the EGA
  165.     (16 color) modes.
  166.  
  167. =============================================================================
  168. Commands in menu mode:
  169. 1.   The up, down, right, and left arrow keys move the cursor around the menu of
  170.         files.
  171.      PgDn/PgUp goto next/previous page.
  172.      Pressing a key goes to next file starting with this character.
  173. 2.   Pressing the spacebar marks a file for viewing or slides, and moves to the
  174.      next file; it will also unmark a previously marked file.
  175. 3.   Pressing enter will display the marked files in the order they were marked.
  176.      If no files were marked, pressing enter displays the file at the cursor.
  177. 4.   Pressing F1 will bring up the help screen; any key will return to the menu.
  178. 5.   Pressing F2 will do a slide show of marked files until a key is pressed.
  179. 6.   Pressing F3 will display the file size and colors on the next to last line.
  180. 7.   Pressing F4 will toggle between VGA and EGA modes.
  181. 8.   Pressing F5/F6 will decrease/increase the default resolution for files
  182.         larger than 320x200 in VGA.
  183. 9.   Pressing F7 goes to LOCK, which forces the default resolution (above)
  184.         no matter what the file size. Pressing F7 again goes to AUTO, which
  185.         automatically selects the resolution to display the picture. Pressing
  186.         F7 again goes back to to the normal mode.
  187. 10.  Pressing F8 toggles the wait mode, where VPIC waits for a keypress between
  188.      multiple images.
  189. 11.  F9 prompts for a new path/filespec, and displays a menu of the files in the
  190.      new path.
  191. 12.  Alt X prompts if you want to delete the file at the cursor. Y deletes it.
  192. 13.  Pressing ESCape ends the program and returns to DOS.
  193. 14.  Pressing Ctrl Break (or Ctrl C) will get you directly to DOS.
  194. All other keys are ignored. If errors are encountered, an error message appears
  195. on the next to last line, and disappears when the cursor is moved. The menu
  196. title is the search spec.
  197.  
  198. DECODING OTHER FILE FORMATS
  199.     The file decoding works in whatever mode you are presently using (VGA or
  200. EGA) and at the resolution you are viewing with. This way, if you choose to save
  201. to another file format, it will be in the same mode you are viewing with (EGA,
  202. MCGA, VGA, or SuperVGA). The decoding is not as fast as could be done, but the
  203. added versatility more than compensates for this. For example, EGA PCX files can
  204. be very quickly decoded to EGA, but are in the wrong format for VGA, and
  205. considerable manipulation is required to produce a VGA image. For all formats
  206. except GIF, the method of viewing is to decode to a buffer for a single line at
  207. 1 byte/pixel, then copy this line to the display in whatever mode you are in.
  208. This is a compromise for most file formats, since they are geared to EGA or VGA,
  209. and display time suffers for the other mode, but it makes the code much simpler.
  210. Besides, the other formats are supported mainly to allow easy conversion to GIF,
  211. which is the preferred format for storage, since it gives the smallest file
  212. size. This will also make EGA <-> VGA conversions possible, which is not
  213. supported by most paint programs.
  214.     The TARGA viewing uses a fixed palette to speed up the decoding, so the
  215. picture does not have what could be called good color. It is mainly there to
  216. verify that an image is present. Use Image Tools TGAPIC to get an equivalent GIF
  217. picture with excellent color rendition.
  218.  
  219. ADDED FEATURES
  220.     VPIC is meant to fill a void not covered by paint programs, and to allow
  221. very convenient file viewing and conversion between file formats. It is not
  222. meant to compete with the paint programs, and in general if a paint program does
  223. something well (such as resize a picture to fill the screen or cut out a portion
  224. of the picture), VPIC will not attempt to do it. On the other hand, if you think
  225. of a feature which would enhance VPIC, please let me know, and I will consider
  226. adding it to the program.
  227.  
  228. KNOWN PROBLEMS
  229. 1.  The ATI 1024x768x16 mode uses 2 pixels/byte, unlike any other VGA or EGA
  230. mode. It is not implemented at this time, and probably never will be because
  231. it would require special cases in the various routines that make up VPIC.
  232. ==============================================================================
  233. Commands while viewing a file (except in slide mode):
  234. 1.   The up/down arrow keys will scroll the picture if longer than the screen.
  235.      The PgUp and PgDn keys will scroll by 10 lines. The Video 7 extended VGA
  236.      boards do not supported writing to non-displayed memory or scrolling pics
  237.      larger than the screen, so this function is disabled for these boards.
  238. 2.   If pic is <= 1/2 the screen width, pressing 2 will give a double size image
  239.      (which may be scrollable) and pressing 1 will give the normal size again.
  240.      For VGA, the picture will be changed only in the horizontal direction; this
  241.      will unsquash some 320x400 pics so the aspect ratio is correct.
  242. 3.   Pressing + will increase the resolution (320x200 to 640x480, etc).
  243. 4.   Pressing - will decrease the resolution; useful if 800x600 rolls.
  244. 5.   Pressing / or ? gives a help screen of commands available while viewing.
  245.  
  246. All the following conversion options check if the default filename is present,
  247. and prompt for a new name if it is. They all now let you know what is happening
  248. while the conversion proceeds. If you screw up at the new filename prompt, hit
  249. Ctrl C to escape immediately to DOS; this will usually preserve a file you don't
  250. want to write over. The safest bet is to view files on floppy, while running
  251. VPIC from the hard disk. The new file is saved to the default drive, which is
  252. the directory you run VPIC from.
  253. 5.   Pressing Z will create a ZSoft (PC Paintbrush) file with the same filename
  254.      and extension PCX. The file will be in whatever mode you are currently
  255.      using (EGA or VGA). The VGA palette will be correct for the latest version
  256.      of PC Paintbrush, which saves a VGA palette in the file.
  257. 6.   Pressing P will create a PC Paint or Pictor file with the same size as the
  258.      current screen. The default extension is .PIC, and for EGA it prompts for a
  259.      PC Paint or Pictor file.
  260. 7.   Pressing G, I, M, U, <, or > will create a GIF file on the default drive,
  261.      and prompt for a new filename-the default extension is GIF. G is for
  262.      non-interlaced, and I is for interlaced, M is for mirror image, U is for
  263.      upside down (inverted), < is rotate image 90 degrees CCW, and > is rotate
  264.      image 90 degrees CW. The GIF file will be the same size as the current
  265.      image.
  266. 8.   Pressing R will create a ColoRix file with the same filename and extension
  267.      SCx where x is a function of the screen size. If in EGA, will prompt if you
  268.      want an EGA Paint or ColoRix file.
  269. 9.   Pressing T will create a Targa 16 file with the same filename and extension
  270.      TGA.
  271. 10.  Pressing C will create a Dr. Halo CUT file with the same filename and
  272.      extension CUT. The pic will be the same size as the GIF file is currently
  273.      on the screen. A palette file will also be created.
  274. 11.  Pressing A will 'animate' a picture by rotating the palette periodically.
  275.      This is especially effective on fractals, where large areas tend to be the
  276.      same color. Pressing spacebar will pause the palette rotation, and pressing
  277.      Enter will terminate it and return to the command mode.  Thus, by waiting
  278.      for an especially nice pattern and then pressing Enter, the pattern can be
  279.      written to a file using the above file save commands. Pressing Esc will
  280.      return to the menu.
  281. 12.  Pressing Alt X will prompt you to delete the current file. If you answer y
  282.      (yes), it will be deleted.
  283. 13.  Pressing enter will return to menu or DOS, or show next file for marked
  284.      menu mode.
  285. 14.  Pressing ESCape will end the display and return to the menu.
  286. 15.  The following keys control the picture tone as follows:
  287.      F1   Decrease red content of picture.
  288.      F2   Increase red content of picture.
  289.      F3   Decrease green content of picture.
  290.      F4   Increase green content of picture.
  291.      F5   Decrease blue content of picture.
  292.      F6   Increase blue content of picture.
  293.      F7   Decrease contrast of picture (VGA only).
  294.      F8   Increase contrast of picture (VGA only).
  295.      F9   Decrease brightness of picture (VGA only).
  296.      F10  Increase brightness of picture (VGA only).
  297.      Alt-F10  Restore original palette after you thoroughly mess up the colors.
  298.      V    Reverses the current palette (16/64 EGA only); interesting effect
  299.           especially for black & white images.
  300.      After a little experimenting, a 'washed out' VGA picture can be greatly
  301.      improved by using F1-F10 , and you can always start over by using Alt-F10.
  302.      To retain a black background in a VGA picture, the brightness should be
  303.      decreased when the contrast is decreased. If you have really improved the
  304.      picture, you can then save it to GIF by pressing G of I. VPIC will prompt
  305.      you if the file exists in the default directory, and you have the option of
  306.      overwriting it or giving a new filename. This works really well with images
  307.      created on the Howtec or Targa scanners.
  308. All other keys are ignored. Pressing Ctrl Break (or Ctrl C) will go to DOS.
  309. ===============================================================================
  310. IMPORTANT: Support for boards with other chip sets: VPIC will support other VGA
  311.     boards with extended VGA modes if the owners will write me with the details
  312.     of how to set the various modes, and how to bank switch the display memory.
  313.     Of course, if you also register VPIC I will give the problem more
  314.     consideration.
  315.         The bank switching Info for some of the 'not so common' VGA boards is
  316.     hard to come by, and is needed if VPIC is to support extended VGA modes for
  317.     these boards. A VGA board needs to bank switch for extended modes because
  318.     there is only a 64K window in the PC address space for graphics memory (from
  319.     A000 to AFFF), and extended modes require more than 64K of memory;
  320.     640x480x256 requires 307200 bytes of memory, or about 4.7 'banks of 64K'.
  321.     Bank switching is a means of mapping the (A000 to AFFF) graphics address
  322.     space into 64K chunks of actual display memory. Bank switching is a function
  323.     of the chip set used on the display board, and what I need is info on how to
  324.     switch banks and how to set the various modes the board supports. The use of
  325.     a display board would also help, since it will allow me to test the program
  326.     with that display board instead of 'programming blind'.
  327. ----------------------------------------------------------------------------
  328. SHAREWARE
  329.            
  330. VPIC is user supported software.  VPIC for the IBM  PC is made available for a
  331. free ten day trial period.  If you find this program useful,  you may license
  332. the  program for non-commercial use on one machine by sending $15.00 to:
  333.  
  334.      Bob Montgomery
  335.      132 Parsons Road
  336.      Longwood, Fl 32779
  337.  
  338. If you are already registered for VGIF (any version) you may upgrade to VPIC for
  339. an additional $5.
  340.  
  341. VPIC may be licensed for commercial use on up to 10 computers at a single site
  342. or set of contiguous sites for $75.00. A commercial site is defined as a
  343. business or individual seeking to make a profit by selling VPIC or incorporating
  344. this program in another program.
  345.  
  346. Clubs, schools,  universities and other organizations may license VPIC for
  347. $45.00 per 6 copies.
  348.  
  349. If you use VPIC as part of a commercial demo or as a utility for another
  350. application you must obtain a license from Bob Montgomery, and pay a $1/copy
  351. royalty for each copy shipped.
  352.  
  353. All other rights are reserved.
  354.  
  355. VPIC may not be changed or modified in any way  except by the author.  VPIC may
  356. be freely distributed for the ten day trial period as long as it remains in its
  357. complete form.  Regardless of how the  copy is  obtained, it is requested that
  358. all users comply with the licensing agreement.
  359.  
  360. All  warranties  are  disclaimed,  including  damage  to hardware and/or
  361. software from use of this product. In no event will I be liable to you for
  362. any damages, including lost profits, lost savings or other incidental or
  363. consequential damages arising out of your use or inability to use the
  364. program, or any other claim by any other party.
  365.  
  366. Contact Bob Montgomery for:
  367.     1. Special versions of VPIC tailored to your application.
  368.     2. Other graphics oriented applications (file conversion, etc).
  369.  
  370. Any suggestions or comments can be mailed directly to me, or left on the
  371. following graphics oriented BBS's:
  372.  
  373. Compuserve PICS Forum (My ID is 73357,3140)
  374. Tsunami BBS, Half Moon Bay, Calif. (415) 726-2726
  375. PC Rockland, S. Nyack, NY (914) 353-2538 [Freeboard] 1.6 Gbyte Online
  376. Megabyte Image Center     (918) 492-0087 1200/2400/9600 baud USR HST
  377. Picture Gallery           (319) 296-1393 1200/2400/9600 baud USR HST
  378. Russ & Edies              (216) 726-0737 1200/2400/9600 baud USR HST
  379. NixPix                    (303) 920-1263 1200/2400/9600 baud USR HST
  380. -------------------------------------------------------------------------
  381. Revision history:
  382. ver 1.1   1-13-88
  383.           Added test for EGA adapter.
  384.           Fixed menu colors.
  385.           Allow ESCape from marked file viewing.
  386.           Added Ctrl Break (or Ctrl C) exit to DOS anywhere.
  387.           Added 'disk full' notification when creating picture file.
  388.           Added critical error handler for 'drive not ready' errors.
  389. ver 1.2   1-15-88
  390.           Changed name to vgif.
  391.           Slide mode now ignore the end of file mark in slide file, and any key
  392.                will now end slide mode.
  393.           Added slides to menu mode if S pressed-shows marked files as slides
  394.                until a key is pressed.
  395. ver 1.3   1-21-88
  396.           Added better error checking to GIF file decoding. Notifies if bad GIF
  397.                file.
  398.           Fixed error reporting bug in single file mode.
  399. ver 1.4   2-9-88
  400.           Added instantaneous screen update in slide mode from menu or command
  401.                (sld) file.
  402.           Added the /r option which allows an application program to call vgif
  403.                to view a file and then regain control.
  404. ver 1.5   3-2-88
  405.           Added Page Up and Page Down keys to scroll by 10 lines at a time.
  406.           Added a max pic height of 819 lines so EGA buffer would not overflow.
  407.           Greatly improved color reproduction for 'problem' pictures (such as
  408.               FROG, ARCHIT, PUFFIN, VEGTABLE, etc). These pictures typically
  409.               have more than 16 colors. Selected colors on basis of frequency
  410.               of use where possible.
  411.           Fixed following bugs:
  412.           1.  Line buffer would overflow into other variables if pic width
  413.               was > 640 pixels, causing strange results.
  414.           2.  Didn't recognize the end of image marker correctly. This would
  415.               cause the palette to change when the image was done.
  416. ver 1.6   3-11-88
  417.           Fixed a bug in handling multiple images. First noticed when viewing
  418.                WHIMMI.GIF.
  419.           Use same palette for multiple images, and get best color match.
  420.           Added L and S commands while viewing a picture. These allow you to
  421.                create full size paint program files.
  422.  
  423. ver 2.0   3-26-88
  424.           Added the ability to view long GIF files ( > 819 lines) without
  425.                wrapping the display.
  426.           Added the C and H (Dr. Halo) file creation option while viewing.
  427.           Added the L and S prefixes to paint program file creation commands
  428.                while viewing to save long pic files.
  429.           Added the Info and Help commands in menu mode.
  430.           Deleted the # requirement to specify a directory from the command
  431.                line. The program now looks for a directory which meets the
  432.                spec on the command line. If none is found, it assumes the spec
  433.                is for a single file.
  434.           Added F1 - F10, and V palette control keys while viewing a file.
  435.  
  436. ver 3.0   5-2-88
  437.           Added VGA capability, and support for Tseng extended VGA modes
  438.                (640x480x256 and 800x600x256).
  439.           Determines and displays available modes for your system.
  440.  
  441. ver 3.1   5-11-88
  442.           Fixed a bug in dir/file spec from command line. Now accepts
  443.                vgif d:\dir\*.gif or vgif d:*.gif, although the [\]*.gif is not
  444.                required, since this is the default filespec.
  445.           Fixed a bug in forced EGA when doing slides, where an interlaced pic
  446.                displayed at double size would have a 'venetian blind' effect.
  447.           Changed so pics larger than 320x200 are shown in 640x480 VGA; can get
  448.                800x600 by pressing + key.
  449.           Note that EGA mode on the Orchid VGA card appears squashed
  450.                vertically. This is normal, and cannot be corrected without
  451.                reprograming the parameters for mode 16, which would change
  452.                the vertical retrace frequency, and probably cause your monitor
  453.                to roll.
  454.  
  455. ver 3.2   5-26-88
  456.           Added 500 file menu, and assy language text screen updating; now
  457.                super fast.
  458.           Fixed a bug which caused the Vega VGA card to hang up.
  459.  
  460. ver 3.3   6-9-88
  461.           Added user spec of video mode for non-Orchid VGA boards.
  462.           Added GIF and Pictor save of current screen for VGA/EGA pics.
  463.           Added prompts to screen for conversion to other formats.
  464.           Removed conversion starting at first visible row-now does whole pic.
  465.  
  466. ver 3.4   6-23-88
  467.           Fixed a bug in the GIF save routine.
  468.           Added color, contrast, and brightness adjustment in VGA.
  469.           Fixed a bug in menu mode for marked files.
  470.           Added /n command line option to stay in 640x480x256 for VGA pics.
  471.  
  472. ver 3.5   7-14-88
  473.           Fixed some misc minor bugs.
  474.           Added increase/decrease resolution command while viewing 16 color VGA
  475.                pics (using the /e option).
  476.           Added slide mode for VGA.
  477.           Added lock mode option to start pics from the menu in a desired mode.
  478.  
  479. ver 3.6   8-8-88
  480.           Fixed some bugs.
  481.           Fixed EGA slide show.
  482.  
  483. ver 3.6A  9-10-88
  484.           Fixed 1024x768x16 mode.
  485.  
  486. VPIC ver 1.0 & 1.1 12-27-88
  487.           Beta test versions.
  488.  
  489. VPIC ver 1.2   12-27-88
  490.           Added configuration option for various display boards.
  491.           Added VGA file conversion for all previous Paint programs supported.
  492.           Added Deluxe Paint 2 conversion.
  493.           Added Targa 16 file conversion.
  494.           Added EGA/VGA toggle from menu.
  495.           Added default resolution select, and Mode Lock key from menu.
  496.           Added WAIT option to pause between images of multi-image files.
  497.           Added MAC, PCX, & Colorix file viewing capability. Others will be
  498.             added in later versions.
  499.           Added 'animate' while viewing.
  500.           Fixed VGA 16 color palette.
  501.  
  502. VPIC ver 1.2A   1-4-89
  503.           Fixed MAC -> GIF conversion
  504.           Fixed CVPIC for ^Z as EOF char.
  505.           Fixed 16 color palette for other file formats if VGA 16 colors.
  506.  
  507. VPIC ver 1.3    2-2-89
  508.           Fixed cursor in menu.
  509.           Fixed 'lock up' if GIF header size wrong (640x350 labeled 350x640).
  510.           Now pauses pic if file error and waits for key press-can see partial
  511.             pics in bad files this way.
  512.           Shows GIFs with MAC headers (1st 128 bytes are not GIF standard);
  513.             if F3 (info) pressed shows if file has a MAC header.
  514.           Fixed so views and saves new ZSoft VGA PCX files which include
  515.             palette at end of file. Still doesn't load PAL files.
  516.           Fixed ZSoft file displays and saves.
  517.           Added Wait toggle (F8) which pauses between images in multi-image
  518.             GIFs, and allows conversion to other filetypes.
  519.           Made MACs black on bright white instead of gray.
  520. VPIC ver 1.4   3-15-89
  521.           Added printout of filename while decoding except in slide mode.
  522.           Added help while viewing a picture; press ? or /.
  523.           Added delete a file option X (with query) while viewing.
  524.           Added hit Escape while decoding to abort picture.
  525. VPIC ver 1.5   3-23-89
  526.           Fixed bug in 'Escape while decoding' which would hang system.
  527.           Fixed EGA x2 display for interlaced files.
  528.           Fixed problem with saving a pic after scrolling.
  529.           Fixed palette in animate, so save will use current palette.
  530.           Fixed problem with bad files in slide mode that would hang computer.
  531.           Fixed error display in /@ slide mode and single file mode.
  532. VPIC ver 1.6   4-5-89
  533.           Fixed bugs in slide show from command file. Added comments.
  534.           Added resolution option for each picture in slide command file.
  535.           Fixed miscellaneous minor bugs.
  536.           Added configurable menu color.
  537.  
  538. VPIC ver 1.7   6-13-89
  539.           Added Trident chip set support (for Maxxon and Logix VGA boards
  540.             and maybe the ATI board).
  541.           Fixed a few bugs concerned with putting & getting lines from the
  542.             display screen.
  543.           Fixed problem with Ctrl Z at end of slide definition file.
  544.  
  545. VPIC ver 1.8  6-28-89
  546.           Added EGA Paint viewing/conversion.
  547.           Fixed conversion to 800x600 ColoRIX file.
  548.           Fixed other minor bugs.
  549.  
  550. VPIC ver 1.9  7-19-89
  551.           Added inverted, mirrored, and rotated GIF saves.
  552.           Fixed a bug in the Dr Halo CUT file creation.
  553.           Added menu updating after file creation or deletion.
  554.           Added new path spec feature from menu with F9 key.
  555.  
  556. VPIC ver 2.0  8-6-89
  557.           Added Pictor/PC Paint PIC, Dr. Halo CUT, Deluxe Paint LBM, and
  558.               Targa 16 or 24 file viewing capability.
  559.           Fixed a bug in the palette selection for EGA.
  560.           Fixed a bug which would not show VGA for the plain vanilla VGA config.
  561.           Fixed a bug in the ZSoft PCX display for extended EGA modes.
  562.           Added Auto resolution option and switch from the menu (F7).
  563.           Made cursor stay fixed when files are created or deleted.
  564.           Added Chips & Technology support. (VPIC 2.0A)
  565.           Fixed ZSoft save at higher screen resolution than pic. (VPIC 2.0B)
  566.  
  567. VPIC ver 2.1  9-5-89
  568.           Fixed a bug in LBM viewing
  569.           Added ColoRIX 16 color SCR and SCP view/create.
  570.           Speeded up GIF decoding about 50%.
  571.  
  572. VPIC ver 2.1A 9-10-89
  573.           Fixed a memory allocation problem for slides.
  574.           Made small increase in speed.
  575.           Fixed directory callout (*.PIC, etc).
  576.           Re-enabled ESC for GIF viewing.
  577.           Fixed Chip & Tech bank switching routine.
  578.           Fixed Deluxe Paint II (LBM) file creation.
  579.  
  580. VPIC ver 2.2 10-23-89
  581.           Fixed problem in new path command (F9 from menu).
  582.           Fixed intermittent GIF decode problem.
  583.           Program now tells if GIF image and screen sizes conflict.
  584.           Menu now correctly displays file sizes larger than 1 Mbyte.
  585.           Now lists & displays Electronic Arts IFF files (same as LBM).
  586.